home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmeGetNextCharacter.z / XmeGetNextCharacter
Encoding:
Text File  |  2002-10-03  |  8.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmeeeeGGGGeeeettttNNNNeeeexxxxttttCCCChhhhaaaarrrraaaacccctttteeeerrrr((((3333XXXX))))   UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV   XXXXmmmmeeeeGGGGeeeettttNNNNeeeexxxxttttCCCChhhhaaaarrrraaaacccctttteeeerrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmeeeeGGGGeeeettttNNNNeeeexxxxttttCCCChhhhaaaarrrraaaacccctttteeeerrrr - A compound string parse procedure to
  10.           insert a character
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/XmP.h>
  14.           XXXXmmmmIIIInnnncccclllluuuuddddeeeeSSSSttttaaaattttuuuussss XXXXmmmmeeeeGGGGeeeettttNNNNeeeexxxxttttCCCChhhhaaaarrrraaaacccctttteeeerrrr(
  15.           XXXXttttPPPPooooiiiinnnntttteeeerrrr ****tttteeeexxxxtttt____iiiinnnn____oooouuuutttt,
  16.           XXXXttttPPPPooooiiiinnnntttteeeerrrr tttteeeexxxxtttt____eeeennnndddd,
  17.           XXXXmmmmTTTTeeeexxxxttttTTTTyyyyppppeeee ttttyyyyppppeeee,
  18.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaagggg ttttaaaagggg,
  19.           XXXXmmmmPPPPaaaarrrrsssseeeeMMMMaaaappppppppiiiinnnngggg eeeennnnttttrrrryyyy,
  20.           iiiinnnntttt ppppaaaatttttttteeeerrrrnnnn____lllleeeennnnggggtttthhhh,
  21.           XXXXmmmmSSSSttttrrrriiiinnnngggg ****ssssttttrrrr____iiiinnnncccclllluuuuddddeeee,
  22.           XXXXttttPPPPooooiiiinnnntttteeeerrrr ccccaaaallllllll____ddddaaaattttaaaa);
  23.  
  24.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  25.           This page documents Motif 2.1.
  26.  
  27.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.           XXXXmmmmeeeeGGGGeeeettttNNNNeeeexxxxttttCCCChhhhaaaarrrraaaacccctttteeeerrrr is a compound string parse procedure (a
  29.           function of type XXXXmmmmPPPPaaaarrrrsssseeeePPPPrrrroooocccc).  It is suitable for use as an
  30.           XXXXmmmmNNNNiiiinnnnvvvvooookkkkeeeePPPPaaaarrrrsssseeeePPPPrrrroooocccc procedure in an XXXXmmmmPPPPaaaarrrrsssseeeeMMMMaaaappppppppiiiinnnngggg data
  31.           structure.
  32.  
  33.           XXXXmmmmeeeeGGGGeeeettttNNNNeeeexxxxttttCCCChhhhaaaarrrraaaacccctttteeeerrrr causes the character following the
  34.           pattern characters to be used as output to the compound
  35.           string under construction.  The function assumes that
  36.           _t_e_x_t__i_n__o_u_t points to the first byte of the first character
  37.           in the matched pattern.  It creates a compound string
  38.           consisting of a component that contains the next character
  39.           following the matching characters.  It sets _t_e_x_t__i_n__o_u_t to a
  40.           pointer to the first byte following the character parsed.
  41.  
  42.           _t_e_x_t__i_n__o_u_t
  43.                     Specifies the text being parsed.  The value is a
  44.                     pointer to the first byte of text matching the
  45.                     pattern that triggered the call to the parse
  46.                     procedure.  When the parse procedure returns, this
  47.                     argument is set to the position in the text where
  48.                     parsing should resume; that is, to the byte
  49.                     following the character parsed by the parse
  50.                     procedure.
  51.  
  52.           _t_e_x_t__e_n_d  Specifies a pointer to the end of the _t_e_x_t__i_n__o_u_t
  53.                     string.  If _t_e_x_t__e_n_d is _N_U_L_L, the string is
  54.                     scanned until a _N_U_L_L character is found.
  55.                     Otherwise, the string is scanned up to, but not
  56.                     including, the character whose address is
  57.                     _t_e_x_t__e_n_d.
  58.  
  59.           _t_y_p_e      Specifies the type of text and the type of
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmeeeeGGGGeeeettttNNNNeeeexxxxttttCCCChhhhaaaarrrraaaacccctttteeeerrrr((((3333XXXX))))   UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV   XXXXmmmmeeeeGGGGeeeettttNNNNeeeexxxxttttCCCChhhhaaaarrrraaaacccctttteeeerrrr((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                     compound string component the function creates.
  75.                     If _t_y_p_e is XXXXmmmmCCCCHHHHAAAARRRRSSSSEEEETTTT____TTTTEEEEXXXXTTTT and _t_a_g is other than
  76.                     XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG, the function creates a
  77.                     component of type XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____TTTTEEEEXXXXTTTT.  If
  78.                     _t_y_p_e is XXXXmmmmCCCCHHHHAAAARRRRSSSSEEEETTTT____TTTTEEEEXXXXTTTT and _t_a_g is
  79.                     XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG, or if _t_y_p_e is
  80.                     XXXXmmmmMMMMUUUULLLLTTTTIIIIBBBBYYYYTTTTEEEE____TTTTEEEEXXXXTTTT, the function creates a component
  81.                     of type XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____LLLLOOOOCCCCAAAALLLLEEEE____TTTTEEEEXXXXTTTT.  If _t_y_p_e
  82.                     is XXXXmmmmWWWWIIIIDDDDEEEECCCCHHHHAAAARRRR____TTTTEEEEXXXXTTTT, the function creates a
  83.                     component of type
  84.                     XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____WWWWIIIIDDDDEEEECCCCHHHHAAAARRRR____TTTTEEEEXXXXTTTT.
  85.  
  86.           _t_a_g       Specifies the tag to be used along with a _t_y_p_e of
  87.                     XXXXmmmmCCCCHHHHAAAARRRRSSSSEEEETTTT____TTTTEEEEXXXXTTTT in determining the type of compound
  88.                     string component the function creates.
  89.  
  90.           _e_n_t_r_y     Specifies the parse mapping that triggered the
  91.                     call to the parse procedure.
  92.  
  93.           _p_a_t_t_e_r_n__l_e_n_g_t_h
  94.                     Specifies the number of bytes in the input text,
  95.                     following _t_e_x_t__i_n__o_u_t, that constitute the matched
  96.                     pattern.
  97.  
  98.           _s_t_r__i_n_c_l_u_d_e
  99.                     Specifies a pointer to a compound string.  The
  100.                     parse procedure creates a compound string to be
  101.                     included in the compound string being constructed.
  102.                     The parse procedure then returns the compound
  103.                     string in this argument.
  104.  
  105.           _c_a_l_l__d_a_t_a Specifies data passed by the application to the
  106.                     parsing routine.
  107.  
  108.      RRRREEEETTTTUUUURRRRNNNN
  109.           This function returns XXXXmmmmIIIINNNNSSSSEEEERRRRTTTT, indicating that the parsing
  110.           routine should concatenate the result to the compound string
  111.           being constructed and continue parsing.
  112.  
  113.      RRRREEEELLLLAAAATTTTEEEEDDDD
  114.           XXXXmmmmPPPPaaaarrrrsssseeeeMMMMaaaappppppppiiiinnnngggg(3), XXXXmmmmPPPPaaaarrrrsssseeeeTTTTaaaabbbblllleeee(3), XXXXmmmmSSSSttttrrrriiiinnnngggg(3), and
  115.           XXXXmmmmeeeeGGGGeeeettttDDDDiiiirrrreeeeccccttttiiiioooonnnn(3).
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.